home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 076-100 / scopedisk89 / zapmap / instructions < prev    next >
Text File  |  1995-03-19  |  5KB  |  103 lines
  1.  
  2. ZapMap13 - Copyright 1989 by Michael Brandon - All Rights Reserved
  3. Released to Public Domain by author - April, 1989.
  4.  
  5.  
  6. What is it?
  7.     ZapMap13 contains the equivalent of AmigaDos 1.3 .bmap files (accounting
  8.     for it's size). Running the program is all that a BASIC programmer will
  9.     need to use the Amiga's LIBRARY Functions.  You can throw away your 1.3
  10.     .bmap files if you choose (NOT recommended!) as you will not need them
  11.     to either use this program or to use the LIBRARY functions in your own
  12.     BASIC programs.  It can also be used with Absoft's AC-BASIC (and other
  13.     BASICS that require the use of .bmaps to make library calls) enabling
  14.     you to create TRUE stand alone programs!
  15.  
  16. What does it do?
  17.     ZapMap13 will create a small SUB Program and will append that SUB
  18.     program to the end of YOUR BASIC program (if you so desire).  The SUB
  19.     Program adopts the name of the LIBRARY you have chosen to use.  In YOUR
  20.     program where you would normally have the statement (for Example):
  21.                                 LIBRARY "graphics.library"
  22.  
  23.     You will substitute the statement:
  24.                                 GRAPHICS.LIBRARY
  25.  
  26.     Every other programming statement in YOUR program remains the same - You
  27.     must still use the DECLARE FUNCTION statement and you must CLOSE the
  28.     library before exiting YOUR program by using the LIBRARY CLOSE
  29.     statement.
  30.  
  31. How to Use ZapMap:
  32.  
  33.     Either double-click the icon from WorkBench or start the program from
  34.     the CLI by typing: ZapMap
  35.  
  36.     As soon as the program loads (it takes a few seconds because of it's
  37.     size), you will be asked to select a library from the MENU.  Select the
  38.     Library you want to use in YOUR program.
  39.  
  40.     The Program will then Create a list of all of the functions accessable
  41.     by BASIC for the chosen library.  It will list them in alphabetical
  42.     order and assign a number to each.
  43.  
  44.     You simply follow the program's instructions and select the functions
  45.     you wish to use by it's NUMBER.  Select as many or as few as you want,
  46.     they will high-light when selected.  If you change your mind, select the
  47.     function again and it will become "UN-selected?" (and UN-high-lighted).
  48.     When you have what you want press ESC to quit selecting functions.
  49.  
  50.     Now the program will ask you for the NAME of YOUR BASIC program to
  51.     APPEND the SUB Program.  You can optionally give it any filename you
  52.     wish and it will either APPEND to the named file or CREATE it if it does
  53.     not exist and write the SUB there.
  54.  
  55.     IMPORTANT NOTE: YOUR BASIC PROGRAM must be in ASCII format and NOT in
  56.     AmigaBASIC's compressed format. (ie. SAVE it using option "A").
  57.  
  58.     You can now choose additional libraries and repeat the above steps or
  59.     you can QUIT.
  60.  
  61.     Look at the file you named and you will see a new SUB program appended
  62.     at the END of it.  You CALL this SUB from within YOUR program INSTEAD of
  63.     using the AmigaBasic LIBRARY statement.  (See bove paragraph titled
  64.     "What does it do?").  Be sure to follow ALL OTHER rules for using
  65.     LIBRARY CALLS in BASIC including DECLARE FUNCTION, if required, and
  66.     LIBRARY CLOSE.  You should also use the BASIC "KILL" statement to clean
  67.     up the RAM: disk before exiting YOUR program by deleting .bmap files
  68.     created in RAM: (Not absolutely necessary - if you want to keep the
  69.     created .bmap files, save them to disk - they can be used in the normal
  70.     way).
  71.  
  72. Other Stuff You Need to know:
  73.  
  74.     Some Libraries contain more functions than will fit on one screen.  Use
  75.     the UP ARROW and DOWN ARROW to view all the functions and their numbers.
  76.  
  77.     You will notice that the SUB program created opens a file to write the
  78.     RAM: bmap string.  The File opened is #255.  The High number was used to
  79.     avoid conflict with any already opened files in YOUR program (most
  80.     people would not normally use file #255). In the event YOUR program has
  81.     file #255 already open, you will need to change ONE of the file numbers
  82.     to something else.
  83.  
  84.     This program is for use with Operating System 1.3 ONLY.  I have others
  85.     for Operating System 1.2 and 1.1.  I even have one for the ARP library.
  86.     They are called ZapMap11, ZapMap12, and ZapMapA (I'm sure you can figure
  87.     out which is which). You can probably find these on the same BBS where
  88.     you got this one, or you can get everything on one disk plus some other
  89.     useful tools for advanced BASIC programming by sending a blank disk and
  90.     $5.00 for postage (plus my trouble) to:
  91.  
  92.                 Michael Brandon
  93.                 378 La Mancha Av.
  94.                 Royal Palm Beach, Fla 33411
  95.  
  96.     You may also send any suggestions, complaints or compliments to the
  97.     above address.
  98.  
  99.     OR.. You may just USE the programs with my good wishes for your success!
  100.  
  101.                                     == M.B.==
  102.  
  103.